// @ts-check

/**
 * 这是一个类型安全的JavaScript文件示例
 * 包含了 @ts-check 注释，启用了TypeScript类型检查
 */

/**
 * 计算两个数的和
 * @param {number} a 第一个数
 * @param {number} b 第二个数
 * @returns {number} 两数之和
 */
function add(a, b) {
  return a + b;
}

/**
 * 用户信息接口
 * @typedef {Object} User
 * @property {string} name - 用户名
 * @property {number} age - 年龄
 * @property {string} email - 邮箱
 */

/**
 * 创建用户
 * @param {User} userData 用户数据
 * @returns {User} 用户对象
 */
function createUser(userData) {
  return {
    name: userData.name,
    age: userData.age,
    email: userData.email
  };
}

export { add, createUser }; 